Retrieving Order Updates
To retrieve updates for orders using the Warehouse API, you can use query parameters with the list endpoint. For instance:
GET /warehouse/v1/orders?PrimaryReference=12345678 HTTP/1.1
x-api-key: your_api_key
organization-slug: your_organization_slug (if required)
Although our query parameters allow you to "poll" for updates within a time range, this approach is not recommended. Due to the distributed nature of our system, there's a slight chance an update might become available through the API after it is updated, which could lead to potentially lost data.
Instead, we highly recommend using the webhooks solution for real-time updates. This ensures that you receive accurate, timely information and minimizes the risk of data loss. For more information about webhooks and how to set them up, please refer to the webhook documentation under Shipments -> Shared Features.
Example Response
{
"data": {
"orders": [
{
"id": "680a65ba3e128e236fbe5071",
"dateCreated": "2025-04-24T16:24:26+00:00",
"dateLastUpdated": "2025-04-24T16:25:40+00:00",
"status": "PRS",
"warehouseCode": "LAW",
"primaryReference": "56784321",
"secondaryReference": "PO100123",
"shipToAddress": {
"address": {
"organization": "Target Store #100",
"addressLine1": "123 Main Street",
"addressLine2": "",
"country": "USA",
"state": "CA",
"city": "Los Angeles",
"postalCode": "90012",
"isResidential": false
},
"contact": {
"personName": "Jane Doe",
"phoneNumber": "111-222-3333",
"mobileNumber": "",
"faxNumber": "",
"emailAddress": "jane.doe@target.com"
}
},
"requiredShipDate": "2023-05-15T00:00:00+00:00",
"jobCosting": {
"branch": "CNO"
},
"packingRequired": false,
"excludeFromTotePicking": false,
"transportDetail": {},
"orderLines": [
{
"lineNumber": "1",
"externalLineReference": "001",
"productCode": "LGT-K380-BT-KYBD",
"quantity": 15,
"quantityUnit": "UNT",
"linePrice": 0,
"lineAttributes": [],
"lineCustomAttributes": [],
"partAttributes": []
},
{
"lineNumber": "2",
"externalLineReference": "002",
"productCode": "HP-SPX360-14-OLED-I7-16GB-1TB-NFBLK",
"quantity": 22,
"quantityUnit": "UNT",
"linePrice": 0,
"lineAttributes": [],
"lineCustomAttributes": [],
"partAttributes": []
},
{
"lineNumber": "3",
"externalLineReference": "003",
"productCode": "SAM-GS22ULTRA-SILCASE-BLK",
"quantity": 20,
"quantityUnit": "UNT",
"linePrice": 0,
"lineAttributes": [],
"lineCustomAttributes": [],
"partAttributes": []
}
],
"forwardingData": {},
"shipments": [
{
"id": "680a65ba3e128e236fbe5072",
"wmsId": "W01560131",
"status": "ENT",
"dateCreated": "2025-04-24T16:24:26+00:00",
"dateLastUpdated": "2025-04-24T16:25:40+00:00",
"warehouseCode": "LAW",
"primaryReference": "56784321",
"secondaryReference": "PO100123",
"shipToAddress": {
"address": {
"addressLine1": "123 Main Street",
"addressLine2": "",
"country": "US",
"state": "CA",
"city": "Los Angeles",
"postalCode": "90012",
"isResidential": false,
"addressNote": ""
},
"contact": {
"personName": "Jane Doe",
"phoneNumber": "111-222-3333",
"emailAddress": "jane.doe@target.com"
}
},
"requiredShipDate": "2023-05-15T16:00:00+00:00",
"transportDetail": {
"serviceLevelCode": ""
},
"totalCost": "0",
"totalCostUnit": "USD",
"packages": [],
"forwardingData": {
"incoTerm": ""
},
"serviceLevel": "",
"packingRequired": false,
"excludeFromTotePicking": false,
"shipmentLines": [
{
"sublines": [],
"lineNumber": "3",
"externalLineReference": "003",
"productCode": "SAM-GS22ULTRA-SILCASE-BLK",
"quantity": 0,
"quantityUnit": "UNT",
"linePrice": 0,
"lineAttributes": [
{
"key": "REC ID",
"value": ""
}
],
"lineCustomAttributes": [],
"partAttributes": [],
"palletId": ""
},
{
"sublines": [],
"lineNumber": "1",
"externalLineReference": "001",
"productCode": "LGT-K380-BT-KYBD",
"quantity": 0,
"quantityUnit": "UNT",
"linePrice": 0,
"lineAttributes": [
{
"key": "REC ID",
"value": ""
}
],
"lineCustomAttributes": [],
"partAttributes": [],
"palletId": ""
},
{
"sublines": [],
"lineNumber": "2",
"externalLineReference": "002",
"productCode": "HP-SPX360-14-OLED-I7-16GB-1TB-NFBLK",
"quantity": 0,
"quantityUnit": "UNT",
"linePrice": 0,
"lineAttributes": [
{
"key": "REC ID",
"value": ""
}
],
"lineCustomAttributes": [],
"partAttributes": [],
"palletId": ""
}
],
"milestones": [
{
"code": "WHE",
"description": "ORDER CREATED",
"sequence": "1",
"actualDate": "2025-04-24T16:24:28+00:00"
}
],
"additionalReferences": [
{
"key": "INV",
"value": "INV100123"
}
],
"priority": 0,
"jobCosting": {
"branch": "CNO"
}
}
],
"additionalReferences": [
{
"key": "INV",
"value": "INV100123"
}
],
"priority": 0,
"tags": [],
"additionalNotes": []
}
]
},
"id": "003d9626-770a-4338-a754-fad6a3bdb5e1",
"resource": [],
"errors": []
}